public static EndPointClass refundByEntitlementIds = new EndPointClass("refund/v1", LootLockerHTTPMethod.POST);

// --- Request DTO ---
/// <summary>
/// Request to refund one or more entitlements by their IDs.
/// </summary>
public class LootLockerRefundByEntitlementIdsRequest
{
    /// <summary>
    /// The IDs of the entitlements to refund
    /// </summary>
    public string[] entitlement_ids { get; set; }
}

// --- Response DTOs ---
/// <summary>
/// Represents the action taken on a player inventory item during a refund.
/// </summary>
public class LootLockerRefundPlayerInventoryEvent
{
    /// <summary>
    /// The legacy numeric asset ID
    /// </summary>
    public ulong asset_id { get; set; }
    /// <summary>
    /// Display name of the asset
    /// </summary>
    public string name { get; set; }
    /// <summary>
    /// "removed" if taken back from inventory, "skipped" if it could not be removed (e.g. already consumed)
    /// </summary>
    public string action { get; set; }
}

/// <summary>
/// Represents a currency entry (amount credited or debited) as part of a refund
/// </summary>
public class LootLockerRefundCurrencyEntry
{
    /// <summary>
    /// The ULID of the currency
    /// </summary>
    public string currency_id { get; set; }
    /// <summary>
    /// Short code identifying the currency (e.g. "gold", "gems")
    /// </summary>
    public string currency_code { get; set; }
    /// <summary>
    /// The amount credited or debited, as a string to support arbitrary precision
    /// </summary>
    public string amount { get; set; }
}

/// <summary>
/// Represents a non-reversible reward that was granted alongside an entitlement and could not be clawed back
/// </summary>
public class LootLockerRefundNonReversibleReward
{
    /// <summary>
    /// "progression_points": points were added to a progression. "progression_reset": a progression was reset to its initial state.
    /// </summary>
    public string kind { get; set; }
    /// <summary>
    /// The ULID of the progression that was affected
    /// </summary>
    public string id { get; set; }
    /// <summary>
    /// Display name of the progression
    /// </summary>
    public string name { get; set; }
    /// <summary>
    /// The number of points that were granted and cannot be reversed. Only present for kind "progression_points".
    /// </summary>
    public string amount { get; set; }
}

/// <summary>
/// Represents a single warning detail for a refund
/// </summary>
public class LootLockerRefundWarningDetail
{
    /// <summary>
    /// The warning category:
    /// "non_reversible_rewards": rewards granted that cannot be automatically clawed back.
    /// "insufficient_funds": the player does not have enough currency balance to cover the clawback.
    /// "already_refunded": the entitlement was already refunded before this request.
    /// "refund_failed": the entitlement could not be refunded due to an unexpected error.
    /// </summary>
    public string type { get; set; }
    /// <summary>
    /// Human-readable explanation of the warning
    /// </summary>
    public string message { get; set; }
    /// <summary>
    /// The specific rewards ...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

*This pull request was created from Copilot chat.*
>

<!-- START COPILOT CODING AGENT TIPS -->
---

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. [Learn more about Advanced Security.](https://gh.io/cca-advanced-security)